#import <Foundation/Foundation.h>
#import <MapKit/MapKit.h>
#import "Foursquare.h"

//  This Foursquare integration is possible thanks to the Foursquare API by
//  Eric Butler and associates.
//
//  Copyright (C) 2010 Eric Butler <eric@codebutler.com>

/**
 * A FoursquareTip is an object representing a single tip in the
 * Foursquare system.
 *
 * Code used within this class and the supporting API was written by 
 * Eric Butler and other associates.
 *
 * The supporting API can be found in ./FourSquareAPI folder.
 *
 * @author      Eric Butler
 * @author      James Lin
 * @version     2.2.2 
 * @since       2.2.2
 */
@interface FoursquareTip : NSObject

@property (nonatomic, retain) NSString* tipID;            // Identifier of tip
@property (nonatomic, retain) NSString* tipText;          // Text of tip
@property (nonatomic, retain) NSString* tipUserID;        // ID of tip creator
@property (nonatomic, retain) NSString* tipUserFirstName; // First name of tip creator
@property (nonatomic, retain) NSString* tipUserLastName;  // Last name of tip creator
@property (nonatomic, retain) NSString* tipVenueID;       // ID of tip venue
@property (nonatomic, retain) NSString* tipVenueName;     // Name of tip venue
@property (nonatomic, retain) NSString* tipUserImageURL;  // URL of image of tip creator 
@property CLLocationCoordinate2D tipLocation;             // Location of tip

/**
 * Initialize the Foursquare tip.
 *
 * @param identifier     the identifier for the tip
 * @param text           the text of tip
 * @param userID         the ID of tip creator
 * @param userFirstName  the first name of tip creator
 * @param userLastName   the last name of tip creator
 * @param venueID        the ID of tip venue
 * @param venueName      the name of tip venue
 * @param latitude       the latitude of tip location
 * @param longitude      the longitude of the tip location
 * @return               the initialized Foursquare tip
 */
- (id)initWithID:(NSString*)identifier 
			text:(NSString*)text 
		  userID:(NSString*)userID 
   userFirstName:(NSString*)userFirstName 
	userLastName:(NSString*)userLastName 
		 venueID:(NSString*)venueID  
	   venueName:(NSString*)venueName
		latitude:(NSString*)latitude 
	   longitude:(NSString*)longitude;

@end
